[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
CAPTURE
. Summary
capture(str <filename>);
. Description
The capture function is used to open, close, pause, and unpause the
Telix capture file. Depending on what the string variable <filename>
contains, different actions will take place.
If <filename> contains a valid filename (which can include a path),
Telix opens and starts capturing data to that file.
If <filename> is "*CLOSE*", and the capture file is currently open,
it is closed.
If <filename> is "*PAUSE*", and the capture file is currently open,
it is paused.
if <filename> is "*UNPAUSE*", and the capture file is currently open
and paused, it is unpaused.
If <filename> is an empty string (""), Telix takes the same action
as if the user had pressed Alt-L while in terminal mode (which will
depend on whether the capture file is currently open or closed).
. Return Value
A value of -1 is returned if there is a problem performing the indi-
cated function, otherwise a non-zero (TRUE) value is returned.
. Example
if (capture("TELIX.CAP") == -1)
prints("Error opening capture file!");
See Also:
printer
_capture_fname
capture file
capture_stat
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson